風險代幣消息
接口描述
取得AI通过多資料维度，对当前行情下具有下跌風險趋势的代幣的追踪消息資料。
使用场景：
- 适用于当前行情下，对有下跌行情風險的代幣，进行AI实时追踪的消息查询
- 适用于了解出货预警、下跌風險、反弹等風險信号
資料更新频率：每5分鐘更新一次
請求URL
- 方法：
POST - 路径：
/open/v1/ai/getRiskCoinMessageList
积分消耗
- 消耗积分：
3
前置条件
取得 vsTokenId
| 条件 | 说明 | 取得方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用缓存的 vsTokenId，无需重复查询 | 上下文自动提取 |
| 未有 vsTokenId | 调用 POST /vs-token/list 接口取得 | 前置接口调用 |
請求参数
参数通过請求體（Body）以 JSON 格式传递。
| 参数名 | 類型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | long | 是 | 代幣 ID |
回應欄位
仅展示 data 数组内每个对象的欄位结构：
| 欄位 | 類型 | 实际返回類型 | 描述 |
|---|---|---|---|
| updateTime | long | long | 更新时间（毫秒时间戳） |
| vsTokenId | long | string | VS Token ID |
| symbol | string | string | 代幣名称 |
| name | string | string | 代幣名称 |
| riskMessageType | integer | integer | 预測類型 |
| scoring | number | number | 得分（可能返回空字符串） |
| grade | integer | integer | 等级（可能返回空字符串） |
| price | number | string | 幣价 |
| percentChange24h | number | number | 24 小时跌涨幅 |
| riskDecline | number | number | 風險跌幅 |
| rebound | number | number | 反弹 |
欄位业务含义
| 欄位 | 业务含义 | 使用建议 |
|---|---|---|
| riskMessageType | 風險消息類型 | 識別風險信号類型，如出货预警、下跌風險、反弹等 |
| riskDecline | 風險跌幅 | 推送后价格下跌幅度，用于驗證風險预警准确性 |
| rebound | 反弹幅度 | 价格下跌后的反弹程度 |
請求示例
json
{
"vsTokenId": 38178 // 代幣id
}cURL 示例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getRiskCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 38178
}'cURL 示例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getRiskCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 38178}"成功回應示例
json
{
"code": 200,
"message": "success",
"data": [
{
"updateTime": 1771317300000, // 更新时间
"vsTokenId": "38178", // VS Token ID
"symbol": "TRUTH", // 代幣名称
"name": "Swarm Network", // 代幣名称
"riskMessageType": 19, // 预測類型
"scoring": "", // 得分
"grade": "", // 等级
"price": "0.011799", // 幣价
"percentChange24h": -2.32385979, // 24 小时跌涨幅
"riskDecline": 26.376997000000003, // 風險跌幅
"rebound": 6.613434999999999 // 反弹
},
{
"updateTime": 1771317000000,
"vsTokenId": "38178",
"symbol": "TRUTH",
"name": "Swarm Network",
"riskMessageType": 19,
"scoring": "",
"grade": "",
"price": "0.013825",
"percentChange24h": -0.69409195,
"riskDecline": 15.444089,
"rebound": 4.466107
},
{
"updateTime": 1771316700000,
"vsTokenId": "38178",
"symbol": "TRUTH",
"name": "Swarm Network",
"riskMessageType": 19,
"scoring": "",
"grade": "",
"price": "0.014154",
"percentChange24h": -0.69409195,
"riskDecline": 10.402556,
"rebound": 0.927115
}
// ... 更多資料省略
],
"requestId": "xxx-xxx-xxx"
}